home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / xbstat.z / xbstat
Encoding:
Text File  |  2001-04-17  |  6.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. xxxxbbbbssssttttaaaatttt((((1111MMMM))))                                                          xxxxbbbbssssttttaaaatttt((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      xbstat - monitor Crossbow (Xbow) traffic
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      xxxxbbbbssssttttaaaatttt [----dddd devname] [----tttt sec]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _x_b_s_t_a_t monitors the traffic from and to each of the active slots of the
  16.      Crossbow (Xbow) i/o interconnect.  It reports the total number of
  17.      micropackets sent from and received at each link.  It also reports the
  18.      LLP retries at each link.
  19.  
  20.      The ----dddd _d_e_v_n_a_m_e option specifies which Crossbow to monitor in a multi-
  21.      Crossbow system.  _d_e_v_n_a_m_e should be a valid Xtalk monitor point under the
  22.      /hw graph.  If the _d_e_v_n_a_m_e is not explicitly specified, xbstat monitors
  23.      /dev/xbmon by default.
  24.  
  25.      The ----tttt _s_e_c option determines the duration of time in units of seconds
  26.      that the Xbow traffic will be monitored.  If this option is not is
  27.      selected, the monitoring continues until the user terminates it with a
  28.      CTRL-C (or intr).
  29.  
  30. OOOOVVVVEEEERRRRVVVVIIIIEEEEWWWW
  31.      _x_b_s_t_a_t gets its information from the two hardware performance counters
  32.      and the Link Auxiliary Status Registers in the Xbow.  It uses a
  33.      multiplexing technique to sample and report the SRC and DST link traffic
  34.      at each XBow slot.  Cumulative counts since the beginning of the
  35.      monitoring period are reported in units of micropackets.
  36.  
  37.      _x_b_s_t_a_t is capable of monitoring any selected Xbow in a multi-Xbow system.
  38.      Use ffffiiiinnnndddd ////hhhhwwww ----nnnnaaaammmmeeee mmmmoooonnnn ----pppprrrriiiinnnntttt |||| ggggrrrreeeepppp xxxxttttaaaallllkkkk to find all possible Xbow
  39.      monitor points. A specific Xbow can be selected in two ways: explicitly,
  40.      as a _d_e_v_n_a_m_e  with the ----dddd option, or implicitly, as a soft link to
  41.      /dev/xbmon.
  42.  
  43.  
  44.      When specifying the Xbow implicitly, first create a symbolic link between
  45.      the selected Xbow monitor point and /dev/xbmon before invoking this
  46.      command. See examples below.
  47.  
  48.      Multiple instances of the command selecting different Xbows can be
  49.      executed at a time.  However, one Xbow can be specified at a time with
  50.      each instance of the command.
  51.  
  52.  
  53.      The monitor data is statistical since the traffic over many links and
  54.      slots is sampled or scanned during any given monitoring period.  All live
  55.      links are monitored for the same amount of time during any monitoring
  56.      cycle.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. xxxxbbbbssssttttaaaatttt((((1111MMMM))))                                                          xxxxbbbbssssttttaaaatttt((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      Note that each slot consists of two links: SRC (Source) and
  75.      DST(Destination).
  76.  
  77.      SSSSllllooootttt          Physical slot being monitored.  I/O slots will be labeled
  78.                    as IO1 through IO12, node slots will have labels N1 through
  79.                    N4. Devices connected to each slot vary and are platform
  80.                    and configuration dependent.
  81.  
  82.      FFFFllllaaaaggggssss         Selected flags from the Link(x) Auxiliary Status register.
  83.  
  84.                    Currently only the "Widget Present" flag is shown to
  85.                    indicate an active/live slot.
  86.  
  87.      SSSSoooouuuurrrrcccceeee        Number of micropackets sent from the SRC link of this slot.
  88.  
  89.      DDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnn   Number of micropackets received at the DST link of this
  90.                    slot.
  91.  
  92.      RRRRccccRRRRttttrrrryyyy        Number of LLP receive retries.
  93.  
  94.      TTTTxxxxRRRRttttrrrryyyy        Number of LLP transmit retries.
  95.  
  96. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  97.           _xxxx_bbbb_ssss_tttt_aaaa_tttt _----_dddd _////_hhhh_wwww_////_mmmm_oooo_dddd_uuuu_llll_eeee_////_1111_////_ssss_llll_oooo_tttt_////_nnnn_1111_////_nnnn_oooo_dddd_eeee_////_xxxx_tttt_aaaa_llll_kkkk_////_0000_////_mmmm_oooo_nnnn _----_tttt _6666_0000
  98.  
  99.      Monitors for 60 seconds the traffic at the Xbow specified.
  100.  
  101.           _llll_nnnn _----_ssss _////_hhhh_wwww_////_nnnn_oooo_dddd_eeee_////_xxxx_tttt_aaaa_llll_kkkk_////_0000_////_mmmm_oooo_nnnn _////_dddd_eeee_vvvv_////_xxxx_bbbb_mmmm_oooo_nnnn_;;;;
  102.  
  103.           _xxxx_bbbb_ssss_tttt_aaaa_tttt _----_tttt _6666_0000
  104.  
  105.      Monitors for 60 seconds the traffic at the Xbow associated with
  106.      /dev/xbmon.
  107.  
  108.           _xxxx_bbbb_ssss_tttt_aaaa_tttt
  109.  
  110.      Monitors traffic until terminated by CTRL-C at the Xbow associated with
  111.      /dev/xbmon.
  112.  
  113. FFFFIIIILLLLEEEESSSS
  114.      /dev/xbmon
  115.  
  116. RRRREEEESSSSTTTTRRRRIIIICCCCTTTTIIIIOOOONNNNSSSS
  117.      The command requires root privilege to run.
  118.  
  119. NNNNOOOOTTTTEEEESSSS
  120.      When a Xbow is not explicitly specified, make sure that /_d_e_v/_x_b_m_o_n points
  121.      to an existing Xbow in the system.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. xxxxbbbbssssttttaaaatttt((((1111MMMM))))                                                          xxxxbbbbssssttttaaaatttt((((1111MMMM))))
  137.  
  138.  
  139.  
  140. SEE ALSO
  141.      lllliiiinnnnkkkkssssttttaaaatttt(1), nnnnssssttttaaaattttssss(1), ssssnnnn(1), hhhhwwwwggggrrrraaaapppphhhh(4).
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.